home *** CD-ROM | disk | FTP | other *** search
/ Hardcore Gamer Resource Kit / Hardcore Gamer Resource Kit - Disc 2.iso / Utils / UNIX / UNZIP520 / README < prev    next >
Text File  |  1996-04-29  |  12KB  |  215 lines
  1. This is the README file for the 30 April 1996 public release of the
  2. Info-ZIP group's portable UnZip zipfile-extraction program (and related
  3. utilities).
  4.  
  5. unzip52.zip      portable UnZip, version 5.2, source code distribution
  6. unzip52.tar.Z    same as above, but compress'd tar format
  7.  
  8. __________________________________________________________________________
  9.  
  10. BEFORE YOU ASK:  UnZip, its companion utility Zip, and related utilities
  11. and support files can be found in many places; read the file "Where" for
  12. further details.  To contact the authors with suggestions, bug reports,
  13. or fixes, continue reading this file (README) and, if this is part of a
  14. source distribution, the file "ZipPorts".  Also in source distributions:
  15. read "BUGS" for a list of known bugs, non-bugs and possible future bugs;
  16. INSTALL for instructions on how to build UnZip; and "Contents" for a com-
  17. mented listing of all the distributed files.
  18. __________________________________________________________________________
  19.  
  20.  
  21. GENERAL INFO
  22. ------------
  23. UnZip is an extraction utility for archives compressed in .zip format (also
  24. called "zipfiles").  Although highly compatible both with PKWARE's PKZIP 
  25. and PKUNZIP utilities for MS-DOS and with Info-ZIP's own Zip program, our
  26. primary objectives have been portability and non-MSDOS functionality.
  27.  
  28. This version of UnZip has been ported to a stupendous array of hardware--
  29. from micros to supercomputers--and operating systems:  Unix (many flavors),
  30. VMS, OS/2 (including DLL version), Windows NT and Windows 95 (including DLL
  31. version), Windows 3.x (including DLL versions), MS-DOS, AmigaDOS, Atari TOS,
  32. Acorn RISC OS, Macintosh, VM/CMS, MVS (mostly), Human68k (mostly), AOS/VS
  33. (partly) and TOPS-20 (partly).  UnZip features not found in PKUNZIP include
  34. source code; default extraction of directory trees (with a switch to defeat
  35. this, rather than the reverse); OS/2, VMS, Unix, RISC OS and Macintosh ex-
  36. tended file attributes; and, of course, the ability to run under most of 
  37. your favorite operating systems.  Plus, it's free. :-)
  38.  
  39. For source distributions, see the main Contents file for a list of what's
  40. included, and read INSTALL for instructions on compiling (including OS-
  41. specific comments).  The individual operating systems' Contents files (for 
  42. example, vms/Contents) may list important compilation info in addition to 
  43. explaining what files are what, so be sure to read them.  Some of the ports 
  44. have their own, special README files, so be sure to look for those, too.
  45.  
  46. See unzip.1 or unzip.doc for usage (or the corresponding UnZipSFX, ZipInfo
  47. and fUnZip docs).  For VMS, unzip_def.rnh or unzip_cli.help may be compiled
  48. into unzip.hlp and installed as a normal VMS help entry; see vms/descrip.mms.
  49.  
  50.  
  51. CHANGES AND NEW FEATURES
  52. ------------------------
  53. The 5.2 release adds many way-cool features:
  54.  
  55.    - new "Unix" extra field to preserve file times across timezones and
  56.       operating systems (and, optionally within Unix, UID/GID info)
  57.    - new OS/2 access-control-list support (LAN Server/Requester, Warp Peer)
  58.    - new OS/2 -l listing of sizes of stored EAs and ACLs
  59.    - new Amiga self-extracting-zipfile support
  60.    - new assembly-language CRC routines for Intel and Motorola processors
  61.    - new -M "more" option
  62.    - extended VMS -b support to allow fixed-length 512-byte file format
  63.    - greatly updated Windows GUI interface (WizUnZip)
  64.    - new DLL ports:  OS/2 (both C and REXX interfaces!), 16- and 32-bit Windows,
  65.       and some Unixen (see below for caveats)
  66.    - new Acorn RISC OS port
  67.    - new VM/CMS port
  68.    - new MVS port (mostly done)
  69.    - new AOS/VS port (partly done)
  70.    - unshrink() rewritten again for lower memory usage; now COPYRIGHT_CLEAN
  71.       is default for all systems (unreducing supported via compilation option)
  72.    - ability to pause zipfile comments with embedded ^S (useful for self-
  73.       extracting archives)
  74.    - many new work-arounds for broken zipfiles, compilers and/or OSes
  75.    - various performance enhancements
  76.    - lots of little fixes and improvements
  77.  
  78. The DLL ports need a little explaining.  Basically, it's like this:  as of
  79. version 5.12, there were no DLL ports.  During the 5.2 beta process, no less
  80. than three completely independent DLL ports showed up.  The first was Scott
  81. Maxwell's OS/2 C and REXX DLL, which involved humongous changes to the code
  82. to support reentrancy; it uses a simple and somewhat awkward strings-based
  83. interface (that is, you basically create an UnZip command line and feed it 
  84. to the API functions).  The second port was Stew Loving-Gibbard's 16-bit
  85. Windows DLL.  It too is strings-based and was created as part of another,
  86. divergent project; it is no longer actively maintained and is therefore not
  87. included with the main sources archive.  The third DLL port was Mike White's
  88. 16- and 32-bit Windows DLLs, created as part of the latest WizUnZip (Windows
  89. graphical interface) update.  It uses a "binary" interface wherein UnZip's
  90. internal variables can be set directly by API calls, without the need for 
  91. any awkward and artificial pseudo-command-line strings.  This interface will
  92. almost certainly become the "standard" UnZip DLL interface, but it still 
  93. needs to be merged with the unique features of the other ports (particularly
  94. the OS/2 REXX code, which is naturally strings-based).  And, of course, none
  95. of this is documented particularly well, other than in the source code.
  96. We'll get to it eventually. :-)
  97.  
  98.  
  99. EXCUSES
  100. -------
  101. The more astute humanoids amongst you will notice that the promised multi-
  102. part archive support did NOT make it into this release.  The maintainer is
  103. most apologetic; 1995 turned out to be a busy year, with a dissertation, a
  104. new job and a new baby all colliding to make life extra-specially busy.  The
  105. massive code changes to support the various DLL ports didn't help any, either.
  106. Multi-part archive support will be the very FIRST item on the list for ver-
  107. sion 6.0, and with luck it will be released within six months or so of this 
  108. release, maybe even by summer.  (No promises, but we'll try hard.)
  109.  
  110. On the plus side, special thanks go to Christian Spieler, who did a spectac-
  111. ular job of integrating patches, fixing bugs, working with a remote VM/CMS
  112. user to make that port fully functional, and just generally picking up a lot 
  113. of the slack.  This release owes a lot to Christian's dedication.
  114.  
  115.  
  116. "IMPOSTERS"
  117. -----------
  118. Info-ZIP is aware of four "imposter" zip programs, one of which creates .zip
  119. files.  The Andrew Toolkit (ATK) comes with a (now-obsolete) drawing editor
  120. called "zip" that creates these files (incompatible with .zip archives, of
  121. course); there is an interpreter for Infocom games called ZIP ("Z-code Inter-
  122. preter Program); Chris Barker has developed a pseudo-random number generator
  123. called "ZIP" for crypto purposes; and SGI may bundle an editor called "zip"
  124. with some versions of their operating system (it has apparently been renamed
  125. to "jot" in newer releases).  The Andrew version actually predates not only
  126. Info-ZIP but also PKWARE (1984), but fortunately it has been replaced by a
  127. program called "figure" that uses the extension ".fi".  The Infocom inter-
  128. preter appears to postdate Info-ZIP's version by a couple of years, although
  129. the documentation is too sparse to be certain.  Barker's and SGI's versions
  130. were certainly publicly released long after Info-ZIP's and may have been 
  131. created after ours, as well (almost certainly in the case of Barker's PRNG).
  132.  
  133. In any case, there's nothing to be done about it now; just be aware of the
  134. potential name collisions and file incompatibilities (and upgrade to "figure"
  135. if you still have Andrew Zip installed).
  136.  
  137.  
  138. DISTRIBUTION
  139. ------------
  140. If you have a question regarding redistribution of Info-ZIP software,
  141. either as-is, as packaging for a commercial product, or as an integral
  142. part of a commercial product, read the Frequently Asked Questions (FAQ)
  143. section of the included COPYING file.
  144.  
  145. Insofar as C compilers are rare on some platforms and the authors only have
  146. direct access to Unix, VMS, OS/2, MS-DOS, NT/Intel, Win95, Mac, Amiga and 
  147. Atari systems, others may wish to provide ready-to-run executables for new 
  148. systems.  In general there is no problem with this; we require only that 
  149. such distributions include this README file, the Where file, the COPYING 
  150. file (contains copyright/redistribution information), and the appropriate 
  151. documentation files (unzip.doc and/or unzip.1 for UnZip, etc.).  If the 
  152. local system provides a way to make self-extracting archives in which both 
  153. the executables and text files may be stored together, that is best (in
  154. particular, use UnZipSFX if at all possible, even if it's a few kilobytes
  155. bigger than the alternatives); otherwise we suggest a bare UnZip executable
  156. and a separate zipfile containing the remaining text and binary files.  If
  157. another archiving method is in common use on the target system (for example,
  158. Zoo or LHa), that may also be used.
  159.  
  160.  
  161. BUGS AND NEW PORTS:  CONTACTING INFO-ZIP
  162. ----------------------------------------
  163. All bug reports and patches (context diffs only, please!) should go to 
  164. Zip-Bugs@wkuvx1.wku.edu, which is the e-mail address for the Info-ZIP
  165. authors.  (Note that a few rare systems require the Zip-Bugs part to be
  166. capitalized as shown; most systems work OK with lowercase "zip-bugs,"
  167. however.)  "Dumb questions" that aren't adequately answered in the docu-
  168. mentation should also be directed here rather than to a global forum such
  169. as Usenet.  (Kindly make certain that your question *isn't* answered by
  170. the documentation, however--a great deal of effort has gone into making
  171. it clear and complete.)  Suggestions for new features can be sent to
  172. info-zip@wkuvx1.wku.edu, a mailing list for the Info-ZIP beta testers, 
  173. for discussion (the authors hang out here as well, of course), although 
  174. we don't promise to act on all suggestions.  If it is something that is 
  175. manifestly useful, sending the required patches to Zip-Bugs directly (as
  176. per the instructions in the ZipPorts file) is likely to produce a quicker 
  177. response than asking us to do it--the authors are always somewhat short 
  178. on time.  (Please do NOT send patches or encoded zipfiles to the info-zip 
  179. address.  Please DO read the ZipPorts file before sending any large patch.
  180. It would be difficult to emphasize this point too much...)
  181.  
  182. If you are considering a port, not only should you read the ZipPorts file,
  183. but also please check in with Zip-Bugs BEFORE getting started, since the 
  184. code is constantly being updated behind the scenes.  For example, VMOS, 
  185. VxWorks, Netware and QDOS ports are claimed to be under construction, al-
  186. though we have yet to see any up-to-date patches.  (Actually, the QDOS
  187. port is apparently finished and available at a site in France; with luck,
  188. it will be fully integrated for the next release.)  We will arrange to send 
  189. you the latest sources.  The alternative is the possibility that your hard 
  190. work will be tucked away in a sub-archive and mostly ignored, or completely 
  191. ignored if someone else has already done the port (and you'd be surprised 
  192. how often this has happened).
  193.  
  194.  
  195. BETA TESTING:  JOINING INFO-ZIP
  196. -------------------------------
  197. If you'd like to keep up to date with our UnZip (and companion Zip utility)
  198. development, join the ranks of beta testers, add your own thoughts and con-
  199. tributions, etc., send a two-line mail message containing the commands HELP
  200. and LIST (on separate lines in the body of the message, not on the subject
  201. line) to mxserver@wkuvx1.wku.edu.  You'll receive two messages listing the 
  202. various Info-ZIP mailing-list formats that are available (and also various
  203. unrelated lists) and instructions on how to subscribe to one or more of them
  204. (courtesy of Hunter Goatley).  As of mid-1996, subscribing to the announce-
  205. ments list requires a command of the form
  206.  
  207.     SUBSCRIBE Info-ZIP-announce "Joe Isuzu"
  208.  
  209. The discussion list is called Info-ZIP; it can be set for either normal or
  210. digest-style delivery.
  211.  
  212.  
  213. -- Greg Roelofs (Cave Newt), UnZip maintainer/container/explainer and
  214.    developer guy, with inspiration from David Kirschbaum
  215.